<!DOCTYPE html>
<html lang="en-US">
    <head>
        <title>Log::Agent - logging agent - metacpan.org</title>
        <link rel="preload" as="fetch" href="https://metacpan.org/account/login_status" crossorigin="anonymous" />
        <link href="https://metacpan.org/_assets/b8ccceeed47a0652049703d99326a9cea4933443.css" rel="stylesheet" type="text/css">
        <script src="https://metacpan.org/_assets/6bfedafe2d7caa915b7d84f61b45936818e3242e.js" type="text/javascript" defer></script>
        <link rel="alternate" type="application/rss+xml" title="Recent CPAN Uploads of Log-Agent - MetaCPAN" href="https://metacpan.org/dist/Log-Agent/releases.rss" />
        <link rel="canonical" href="./Log::Agent.html" />
        <meta name="description" content="logging agent" />
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5">
        <link rel="shortcut icon" href="https://metacpan.org/static/icons/favicon.ico">
        <link rel="apple-touch-icon" sizes="152x152" href="https://metacpan.org/static/icons/apple-touch-icon.png">
        <link rel="search" href="https://metacpan.org/static/opensearch.xml" type="application/opensearchdescription+xml" title="MetaCPAN">
        <script>
          (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
          (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
          m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
          })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

          (function(skey, ga_id){
            ga('create', ga_id, {
              siteSpeedSampleRate : 100,
              storage             : 'none',
              clientId            : localStorage.getItem(skey)
            });
            ga(function(tracker) {
              localStorage.setItem(skey, tracker.get('clientId'));
            });
            ga('send', 'pageview');
          })('ga:clientId', 'UA-27829474-1');
        </script>
<meta name="twitter:card"        content="summary" />
<meta name="twitter:url"         content="https://metacpan.org/pod/Log::Agent" />
<meta name="twitter:title"       content="Log::Agent" />
<meta name="twitter:description" content="logging agent" />
<meta name="twitter:site"        content="metacpan" />
    </head>
    <body>
        <nav class="navbar navbar-default" role="navigation">
            <div class="header-logo-large hidden-xs">
              <a href="https://metacpan.org/" tabindex="0">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#logo" />
                </svg>
              </a>
            </div>
            <div class="header-logo-icon visible-xs">
              <a href="https://metacpan.org/">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#dots" />
                </svg>
              </a>
            </div>
            <ul class="nav navbar-nav menu-items hidden-xs hidden-sm">
              <li><a href="https://metacpan.org/about">About</a></li>
              <li><a href="https://metacpan.org/about/sponsors">Sponsor</a></li>
              <li><a href="https://grep.metacpan.org/">grep::cpan</a></li>
              <li><a href="https://metacpan.org/recent">Recent</a></li>
              <li><a href="https://metacpan.org/about/faq">FAQ</a></li>
              <li><a href="https://metacpan.org/tools">Tools</a></li>
              <li><a href="https://fastapi.metacpan.org/">API</a></li>
            </ul>
            <ul class="nav navbar-nav navbar-right">
                <button type="button" class="searchbar-btn visible-xs visible-sm">
                    <i class="fa fa-search button-fa-icon"></i>
                </button>
                <form action="https://metacpan.org/search" class="searchbar-form visible-md visible-lg search-form form-horizontal">
                   <input type="hidden" name="size" id="metacpan_search-size" value="20">
                  <div class="form-group">
                      <div class="search-group">
                        <i class="fa fa-search"></i>
                        <input type="text" name="q" placeholder="Search the CPAN" size="41" autocorrect="off" autocapitalize="off" spellcheck="false" id="metacpan_search-input" class="form-control" value="">
                      </div>
                  </div>
                </form>
                    <li class="icon-slidepanel visible-xs visible-sm">
                      <button data-toggle="slidepanel" data-target=".slidepanel">
                        <span class="button-fa-icon">
                          <i class="fa fa-bars slidepanel-open"></i>
                          <i class="fa fa-times slidepanel-close"></i>
                        </span>
                      </button>
                    </li>
                <form action="https://metacpan.org/account/logout" method="POST" id="metacpan-logout"></form>
                <li class="dropdown logged_in" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon logged-in-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li><a href="https://metacpan.org/account/identities">Identities</a></li>
                        <li><a href="https://metacpan.org/account/profile">Profile</a></li>
                        <li><a href="https://metacpan.org/account/favorite/list">Favorites</a></li>
                        <li>
                            <a href="./Log::Agent.html#" type="button" onclick="$('#metacpan-logout').submit(); return false">
                              Logout
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_out" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li>
                            <a href="https://metacpan.org/login/github">
                                <i class="fab fa-github fa-fw"></i>
                                GitHub
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/twitter">
                                <i class="fab fa-twitter fa-fw"></i>
                                Twitter
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/google">
                                <i class="fab fa-google fa-fw"></i>
                                Google
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_placeholder">
                    <button>
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                    </button>
                </li>
            </ul>
        </nav>
        <div class="page-content ">
          <!--
          <div class="top-notify-banner">
            <i class="fas fa-info-circle"></i>
          </div>
          -->
          <nav class="sidebar">
            <div class="slidepanel">
              <ul class="nav-list ">
    <li class="nav-header no-margin-top">
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The date that this version of Log-Agent was released.">
      <span class="relatize">12 Apr 2021 00:08:29 UTC</span>
    </li>
  <li>
    Distribution: <a href="https://metacpan.org/dist/Log-Agent">Log-Agent</a>
  </li>
  <li>
    Module version: 1.005
  </li>
  <li>
    <a data-keyboard-shortcut="g s" href="https://metacpan.org/dist/Log-Agent/source/Agent.pm">Source</a>
    (<a href="https://metacpan.org/dist/Log-Agent/source/Agent.pm?raw=1">raw</a>)
  </li>
  <li>
    <a data-keyboard-shortcut="g b" href="https://metacpan.org/dist/Log-Agent/source">Browse</a>
    (<a href="https://metacpan.org/dist/Log-Agent/source?raw=1">raw</a>)
  </li>
    <li>
      <a data-keyboard-shortcut="g c" href="https://metacpan.org/dist/Log-Agent/changes">Changes</a>
    </li>
    <li>
      <a class="nopopup" href="https://metacpan.org/dist/Log-Agent/contribute">How to Contribute</a>
    </li>
    <li>
      <a rel="noopener nofollow" data-keyboard-shortcut="g i" href="https://rt.cpan.org/Public/Dist/Display.html?Name=Log-Agent">Issues</a>
      (1)
    </li>
    <li>
      <a rel="noopener nofollow" href="http://matrix.cpantesters.org/?dist=Log-Agent+1.005" title="Matrix">Testers</a>
        <span title="(pass / fail / na)">(<a rel="noopener nofollow" href="https://www.cpantesters.org/distro/L/Log-Agent.html?oncpan=1&amp;distmat=1&amp;version=1.005&amp;grade=2" style="color: #090">166</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/L/Log-Agent.html?oncpan=1&amp;distmat=1&amp;version=1.005&amp;grade=3" style="color: #900">0</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/L/Log-Agent.html?oncpan=1&amp;distmat=1&amp;version=1.005&amp;grade=4">0</a>)</span>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpants.cpanauthors.org/release/MROGASKI/Log-Agent-1.005">Kwalitee</a>
    </li>
    <li>
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The # people with an indexing permission on Log-Agent who have released something to CPAN in the last 2 years (i.e. the # people likely able to release critical fixes in a timely manner)">
      Bus factor: 0
      </div>
    </li>
    <li>
      License: artistic_2
    </li>
    <li class="nav-header">Activity</li>
    <li>
<div class="activity-graph">
    <img src="https://metacpan.org/dist/Log-Agent/activity.svg?res=month" />
    <div class="comment">24 month</div>
</div>
    </li>
    <li class="nav-header">Tools</li>
    <li>
      <a itemprop="downloadUrl" href="https://cpan.metacpan.org/authors/id/M/MR/MROGASKI/Log-Agent-1.005.tar.gz">
      Download (<span itemprop="fileSize">56.02KB</span>)</a>
    </li>
    <li>
      <a href="https://explorer.metacpan.org/?url=%2Fmodule%2FMROGASKI%2FLog-Agent-1.005%2FAgent.pm">
        MetaCPAN Explorer
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Log-Agent/permissions">
        Permissions
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Log-Agent/releases.rss">
        Subscribe to distribution
      </a>
    </li>
    <li>
      <button class="btn btn-link" data-toggle="modal" data-target="#metacpan_install-instructions-dialog">
        Install Instructions
      </button>
    </li>
    <li>
      <form action="https://metacpan.org/search">
        <input type="hidden" name="q" value="dist:Log-Agent">
        <input type="search" name="q" placeholder="Search distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
      </form>
    </li>
    <li>
      <form action="https://grep.metacpan.org/search">
        <input type="hidden" name="qd" value="Log-Agent">
        <input type="hidden" name="source" value="metacpan">
        <input type="search" name="q" placeholder="grep distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
     </form>
    </li>
    <li class="version-jump">
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/Agent.pm&#39;" class="form-control tool-bar-form">
  <option disabled selected>Jump to version</option>
<option
  disabled
  value="MROGASKI/Log-Agent-1.005"
>1.005
  (MROGASKI on 2021-04-12)</option>
<option
  
  value="MROGASKI/Log-Agent-1.004"
>1.004
  (MROGASKI on 2021-02-13)</option>
<option
  
  value="MROGASKI/Log-Agent-1.003"
>1.003
  (MROGASKI on 2017-11-10)</option>
<option
  
  value="MROGASKI/Log-Agent-1.002"
>1.002
  (MROGASKI on 2017-10-27)</option>
<option
  
  value="MROGASKI/Log-Agent-1.001"
>1.001
  (MROGASKI on 2015-11-30)</option>
<option
  
  value="MROGASKI/Log-Agent-1.000"
>1.000
  (MROGASKI on 2013-08-13)</option>
<option
  
  value="MROGASKI/Log-Agent-0.308"
>0.308
  (MROGASKI on 2013-08-11)</option>
<option
  
  value="MROGASKI/Log-Agent-0.307"
>0.307
  (MROGASKI on 2005-10-02)</option>
<option
  
  value="MROGASKI/Log-Agent-0.306"
>0.306
  (MROGASKI on 2004-02-03)</option>
<option
  
  value="MROGASKI/Log-Agent-0.305"
>0.305
  (MROGASKI on 2003-09-27)</option>
<option
  
  value="MROGASKI/Log-Agent-0.304"
>0.304
  (MROGASKI on 2003-03-08)</option>
<option
  
  value="MROGASKI/Log-Agent-0.303"
>0.303
  (MROGASKI on 2002-10-01)</option>
<option
  
  value="MROGASKI/Log-Agent-0.302"
>0.302
  (MROGASKI on 2002-08-02)</option>
<option
  
  value="MROGASKI/Log-Agent-0.301"
>0.301
  (MROGASKI on 2002-03-19)</option>
<option
  
  value="MROGASKI/Log-Agent-0.300"
>0.300
  (MROGASKI on 2002-03-10)</option>
<option
  
  value="RAM/Log-Agent-0.2.8"
>0.2.8
  (RAM on 2001-04-11)</option>
<optgroup label="BackPAN">'
<option
  
  value="RAM/Log-Agent-0.2.7"
>0.2.7
  (RAM on 2001-03-31)</option>
<option
  
  value="RAM/Log-Agent-0.2.6"
>0.2.6
  (RAM on 2001-03-14)</option>
<option
  
  value="RAM/Log-Agent-0.2.4"
>0.2.4
  (RAM on 2001-03-13)</option>
<option
  
  value="RAM/Log-Agent-0.2.3"
>0.2.3
  (RAM on 2001-03-13)</option>
<option
  
  value="RAM/Log-Agent-0.2.1"
>0.2.1
  (RAM on 2000-11-12)</option>
<option
  
  value="RAM/Log-Agent-0.2.0"
>0.2.0
  (RAM on 2000-11-06)</option>
<option
  
  value="RAM/Log-Agent-0.1.9"
>0.1.9
  (RAM on 2000-10-01)</option>
<option
  
  value="RAM/Log-Agent-0.1.7"
>0.1.7
  (RAM on 2000-07-04)</option>
<option
  
  value="RAM/Log-Agent-0.1.5"
>0.1.5
  (RAM on 2000-06-20)</option>
<option
  
  value="RAM/Log-Agent-0.1.4"
>0.1.4
  (RAM on 2000-03-30)</option>
<option
  
  value="RAM/Log-Agent-0.1.3"
>0.1.3
  (RAM on 2000-03-05)</option>
<option
  
  value="RAM/Log-Agent-0.1.2"
>0.1.2
  (RAM on 1999-12-09)</option>
<option
  
  value="RAM/Log-Agent-0.1.1"
>0.1.1
  (RAM on 1999-12-08)</option>
<option
  
  value="RAM/Log-Agent-0.1.0"
>0.1.0
  (RAM on 1999-12-07)</option>
</optgroup>
</select>
    </li>
    <li class="version-diff">
<select onchange="document.location.href='/release/MROGASKI/Log-Agent-1.005/diff/' + encodeURIComponent(this.value) + '/Agent.pm'
" class="form-control tool-bar-form">
  <option disabled selected>Diff with version</option>
<option
  disabled
  value="MROGASKI/Log-Agent-1.005"
>1.005
  (MROGASKI on 2021-04-12)</option>
<option
  
  value="MROGASKI/Log-Agent-1.004"
>1.004
  (MROGASKI on 2021-02-13)</option>
<option
  
  value="MROGASKI/Log-Agent-1.003"
>1.003
  (MROGASKI on 2017-11-10)</option>
<option
  
  value="MROGASKI/Log-Agent-1.002"
>1.002
  (MROGASKI on 2017-10-27)</option>
<option
  
  value="MROGASKI/Log-Agent-1.001"
>1.001
  (MROGASKI on 2015-11-30)</option>
<option
  
  value="MROGASKI/Log-Agent-1.000"
>1.000
  (MROGASKI on 2013-08-13)</option>
<option
  
  value="MROGASKI/Log-Agent-0.308"
>0.308
  (MROGASKI on 2013-08-11)</option>
<option
  
  value="MROGASKI/Log-Agent-0.307"
>0.307
  (MROGASKI on 2005-10-02)</option>
<option
  
  value="MROGASKI/Log-Agent-0.306"
>0.306
  (MROGASKI on 2004-02-03)</option>
<option
  
  value="MROGASKI/Log-Agent-0.305"
>0.305
  (MROGASKI on 2003-09-27)</option>
<option
  
  value="MROGASKI/Log-Agent-0.304"
>0.304
  (MROGASKI on 2003-03-08)</option>
<option
  
  value="MROGASKI/Log-Agent-0.303"
>0.303
  (MROGASKI on 2002-10-01)</option>
<option
  
  value="MROGASKI/Log-Agent-0.302"
>0.302
  (MROGASKI on 2002-08-02)</option>
<option
  
  value="MROGASKI/Log-Agent-0.301"
>0.301
  (MROGASKI on 2002-03-19)</option>
<option
  
  value="MROGASKI/Log-Agent-0.300"
>0.300
  (MROGASKI on 2002-03-10)</option>
<option
  
  value="RAM/Log-Agent-0.2.8"
>0.2.8
  (RAM on 2001-04-11)</option>
<optgroup label="BackPAN">'
<option
  
  value="RAM/Log-Agent-0.2.7"
>0.2.7
  (RAM on 2001-03-31)</option>
<option
  
  value="RAM/Log-Agent-0.2.6"
>0.2.6
  (RAM on 2001-03-14)</option>
<option
  
  value="RAM/Log-Agent-0.2.4"
>0.2.4
  (RAM on 2001-03-13)</option>
<option
  
  value="RAM/Log-Agent-0.2.3"
>0.2.3
  (RAM on 2001-03-13)</option>
<option
  
  value="RAM/Log-Agent-0.2.1"
>0.2.1
  (RAM on 2000-11-12)</option>
<option
  
  value="RAM/Log-Agent-0.2.0"
>0.2.0
  (RAM on 2000-11-06)</option>
<option
  
  value="RAM/Log-Agent-0.1.9"
>0.1.9
  (RAM on 2000-10-01)</option>
<option
  
  value="RAM/Log-Agent-0.1.7"
>0.1.7
  (RAM on 2000-07-04)</option>
<option
  
  value="RAM/Log-Agent-0.1.5"
>0.1.5
  (RAM on 2000-06-20)</option>
<option
  
  value="RAM/Log-Agent-0.1.4"
>0.1.4
  (RAM on 2000-03-30)</option>
<option
  
  value="RAM/Log-Agent-0.1.3"
>0.1.3
  (RAM on 2000-03-05)</option>
<option
  
  value="RAM/Log-Agent-0.1.2"
>0.1.2
  (RAM on 1999-12-09)</option>
<option
  
  value="RAM/Log-Agent-0.1.1"
>0.1.1
  (RAM on 1999-12-08)</option>
<option
  
  value="RAM/Log-Agent-0.1.0"
>0.1.0
  (RAM on 1999-12-07)</option>
</optgroup>
</select>
    </li>

    <li>
<ul class="dependencies">
  <li class="nav-header">Dependencies</li>
  <li><a href="https://metacpan.org/pod/Tie::Array" title="Tie::Array" class="ellipsis">Tie::Array</a></li>
  <li>
    <hr>
  </li>
  <li>
    <a href="https://metacpan.org/module/Log::Agent/requires">Reverse dependencies</a>
  </li>
  <li>
    <a href="http://deps.cpantesters.org/?module=Log%3A%3AAgent">CPAN Testers List</a>
  </li>
  <li>
    <a href="https://cpandeps.grinnz.com/?dist=Log-Agent">Dependency graph</a>
  </li>
</ul>
    </li>
    <li class="nav-header">Permalinks</li>
    <li>
      <a href="https://metacpan.org/release/MROGASKI/Log-Agent-1.005/view/Agent.pm">This version</a>
    </li>
    <li>
      <a href="./Log::Agent.html">Latest version</a>
    </li>
    <li>
<div class="plussers">
<div class="nav-header">++ed by:</div>
<div>
    1 non-PAUSE user
</div>
</div>
    </li>
    <li>
    </li>
              </ul>
            </div>
          </nav>
          <div class="content-navigation">
<div class="breadcrumbs">
  <span>
    <a data-keyboard-shortcut="g a" rel="author" href="https://metacpan.org/author/MROGASKI" class="author-name">Mark Rogaski</a>
  </span>
  <span>&nbsp;/&nbsp;</span>
  <div class="release dist-release status-latest maturity-released">
    <span class="dropdown"><b class="caret"></b></span>
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/Agent.pm&#39;" class="">
<option
  selected
  value="MROGASKI/Log-Agent-1.005"
>1.005
  (MROGASKI on 2021-04-12)</option>
<option
  
  value="MROGASKI/Log-Agent-1.004"
>1.004
  (MROGASKI on 2021-02-13)</option>
<option
  
  value="MROGASKI/Log-Agent-1.003"
>1.003
  (MROGASKI on 2017-11-10)</option>
<option
  
  value="MROGASKI/Log-Agent-1.002"
>1.002
  (MROGASKI on 2017-10-27)</option>
<option
  
  value="MROGASKI/Log-Agent-1.001"
>1.001
  (MROGASKI on 2015-11-30)</option>
<option
  
  value="MROGASKI/Log-Agent-1.000"
>1.000
  (MROGASKI on 2013-08-13)</option>
<option
  
  value="MROGASKI/Log-Agent-0.308"
>0.308
  (MROGASKI on 2013-08-11)</option>
<option
  
  value="MROGASKI/Log-Agent-0.307"
>0.307
  (MROGASKI on 2005-10-02)</option>
<option
  
  value="MROGASKI/Log-Agent-0.306"
>0.306
  (MROGASKI on 2004-02-03)</option>
<option
  
  value="MROGASKI/Log-Agent-0.305"
>0.305
  (MROGASKI on 2003-09-27)</option>
<option
  
  value="MROGASKI/Log-Agent-0.304"
>0.304
  (MROGASKI on 2003-03-08)</option>
<option
  
  value="MROGASKI/Log-Agent-0.303"
>0.303
  (MROGASKI on 2002-10-01)</option>
<option
  
  value="MROGASKI/Log-Agent-0.302"
>0.302
  (MROGASKI on 2002-08-02)</option>
<option
  
  value="MROGASKI/Log-Agent-0.301"
>0.301
  (MROGASKI on 2002-03-19)</option>
<option
  
  value="MROGASKI/Log-Agent-0.300"
>0.300
  (MROGASKI on 2002-03-10)</option>
<option
  
  value="RAM/Log-Agent-0.2.8"
>0.2.8
  (RAM on 2001-04-11)</option>
<optgroup label="BackPAN">'
<option
  
  value="RAM/Log-Agent-0.2.7"
>0.2.7
  (RAM on 2001-03-31)</option>
<option
  
  value="RAM/Log-Agent-0.2.6"
>0.2.6
  (RAM on 2001-03-14)</option>
<option
  
  value="RAM/Log-Agent-0.2.4"
>0.2.4
  (RAM on 2001-03-13)</option>
<option
  
  value="RAM/Log-Agent-0.2.3"
>0.2.3
  (RAM on 2001-03-13)</option>
<option
  
  value="RAM/Log-Agent-0.2.1"
>0.2.1
  (RAM on 2000-11-12)</option>
<option
  
  value="RAM/Log-Agent-0.2.0"
>0.2.0
  (RAM on 2000-11-06)</option>
<option
  
  value="RAM/Log-Agent-0.1.9"
>0.1.9
  (RAM on 2000-10-01)</option>
<option
  
  value="RAM/Log-Agent-0.1.7"
>0.1.7
  (RAM on 2000-07-04)</option>
<option
  
  value="RAM/Log-Agent-0.1.5"
>0.1.5
  (RAM on 2000-06-20)</option>
<option
  
  value="RAM/Log-Agent-0.1.4"
>0.1.4
  (RAM on 2000-03-30)</option>
<option
  
  value="RAM/Log-Agent-0.1.3"
>0.1.3
  (RAM on 2000-03-05)</option>
<option
  
  value="RAM/Log-Agent-0.1.2"
>0.1.2
  (RAM on 1999-12-09)</option>
<option
  
  value="RAM/Log-Agent-0.1.1"
>0.1.1
  (RAM on 1999-12-08)</option>
<option
  
  value="RAM/Log-Agent-0.1.0"
>0.1.0
  (RAM on 1999-12-07)</option>
</optgroup>
</select>
    <a data-keyboard-shortcut="g d" class="release-name" href="https://metacpan.org/dist/Log-Agent">Log-Agent-1.005</a>
  </div>
<span class="river-gauge-gauge">
  <svg width="24px"
       height="15px"
       version="1.1"
       xmlns="http://www.w3.org/2000/svg"
       xmlns:xlink="http://www.w3.org/1999/xlink">

    <g>
      <title>        River stage one &#10;
          • 7 direct dependents &#10;          • 7 total dependents
      </title>

      <rect x="0"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="5"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="10"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="15"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="20"  y="0" width="4" height="15" fill="#e4e2e2" />
    </g>
  </svg>

</span>
<div id="Log-Agent-fav" class="logged_in">
<form action="https://metacpan.org/account/favorite/add" style="display: inline" onsubmit="return favDistribution(this)">
    <input type="hidden" name="remove" value="0">
    <input type="hidden" name="release" value="Log-Agent-1.005">
    <input type="hidden" name="author" value="MROGASKI">
    <input type="hidden" name="distribution" value="Log-Agent">
    <button type="submit" class="favorite highlight"><span>1</span> ++</button>
</form>
</div>
<div class="logged_out">
<a href="./Log::Agent.html" onclick="alert('Please sign in to add favorites'); return false" class="favorite highlight">
<span>1</span> ++</a>
</div>
   / <span>Log::Agent</span>
</div>
          </div>
          <main class="content">


<nav class="toc">
  <div class="toc-header"><strong>Contents</strong></div>
<ul>
  <li><a href="./Log::Agent.html#NAME">NAME</a></li>
  <li><a href="./Log::Agent.html#SYNOPSIS">SYNOPSIS</a></li>
  <li><a href="./Log::Agent.html#DESCRIPTION">DESCRIPTION</a></li>
  <li><a href="./Log::Agent.html#PRIORITIES-AND-LEVEL">PRIORITIES AND LEVEL</a></li>
  <li><a href="./Log::Agent.html#CHANNELS">CHANNELS</a></li>
  <li><a href="./Log::Agent.html#INTERFACE">INTERFACE</a></li>
  <li><a href="./Log::Agent.html#KNOWN-LIMITATIONS">KNOWN LIMITATIONS</a></li>
  <li><a href="./Log::Agent.html#AUTHOR">AUTHOR</a></li>
  <li><a href="./Log::Agent.html#LICENSE">LICENSE</a></li>
  <li><a href="./Log::Agent.html#SEE-ALSO">SEE ALSO</a></li>
</ul></nav>
<div class="pod anchors">
<h1 id="NAME">NAME</h1>

<p>Log::Agent - logging agent</p>

<h1 id="SYNOPSIS">SYNOPSIS</h1>

<pre><code> use Log::Agent;            # in all reusable components
 logerr &quot;error&quot;;
 logtrc &quot;notice:12&quot;, &quot;notice that&quot; if ...;
 logdie &quot;log and die&quot;;

 use Log::Agent;            # in application&#39;s main
 logconfig(-prefix =&gt; $0);  # simplest, uses default driver

 use Log::Agent;                    # another more complex example
 require Log::Agent::Driver::File;  # logging made to file
 logconfig(-driver =&gt;
     Log::Agent::Driver::File-&gt;make(
         -prefix      =&gt; $0,
         -showpid     =&gt; 1,
         -channels    =&gt; {
             &#39;error&#39;  =&gt; &quot;$0.err&quot;,
             &#39;output&#39; =&gt; &quot;$0.out&quot;,
             &#39;debug&#39;  =&gt; &quot;$0.dbg&quot;,
         },
     )
 );</code></pre>

<h1 id="DESCRIPTION">DESCRIPTION</h1>

<p>The <code>Log::Agent</code> module provides an abstract layer for logging and tracing, which is independent from the actual method used to physically perform those activities. It acts as an agent (hence the name) that collects the requests and delegates processing to a sublayer: the logging driver.</p>

<p>The <code>Log::Agent</code> module is meant to be used in all reusable components, since they cannot know in advance how the application which ends up using them will perform its logging activities: either by emitting messages on stdout and errors on stderr, or by directing messages to logfiles, or by using syslog(3).</p>

<p>The logging interface is common for all the logging drivers, and is therefore the result of a compromise between many logging schemes: any information given at this level must be either handled by all drivers, or may be ignored depending on the application&#39;s final choice.</p>

<h1 id="PRIORITIES-AND-LEVEL"><a id="PRIORITIES"></a>PRIORITIES AND LEVEL</h1>

<p>The <code>Log::Agent</code> module can use both priorities (as defined by syslog(3)) or logging levels, or either, in which case there is an implicit computation of the missing item (i.e. the level 4, for instance, corresponds to the &quot;warning&quot; priority, and vice-versa). See <a href="https://metacpan.org/pod/Log::Agent::Priorities">Log::Agent::Priorities</a> for more details.</p>

<p>A logging level is defined as being a threshold: any level lesser than or equal to that threshold will be logged.</p>

<p>At the <code>Log::Agent</code> level, it is possible to define a trace level and a debug level. Only the messages below those levels (inclusive) will be handed out to the underlying driver for logging. They are used by the logtrc() and logdbg() routines, respectively.</p>

<h1 id="CHANNELS">CHANNELS</h1>

<p>The <code>Log::Agent</code> class defines three logging channels, which are <code>error</code>, <code>output</code> and <code>debug</code>. Depending on the driver used for logging, those channels are ignored (typically with syslog()) or may be implicitely defined (default logging, i.e. the one achieved by the <code>Log::Agent::Driver::Default</code> driver, remaps <code>error</code> and <code>debug</code> to stderr, <code>output</code> to stdout).</p>

<h1 id="INTERFACE">INTERFACE</h1>

<p>Anywhere a <i>message</i> is expected, it can be a single string, or a printf()-like format string followed by the required arguments. The special macro <code>%m</code> is handled directly by <code>Log::Agent</code> and is replaced by the string version of $!, which is the last error message returned by the last failing system call.</p>

<p><b>NOTE</b>: There should not be any trailing &quot;\n&quot; in the <i>message</i> strings, nor any embededed one, although this is not enforced. Remember that the main purpose of <code>Log::Agent</code> is to specify logging messages in a standard way! Therefore, most of the time, a &quot;should&quot; should be read as &quot;must&quot; and &quot;should not&quot; as &quot;must not&quot;, which is the strongest interdiction form available in English, as far as I know.</p>

<p>Here are valid <i>message</i> examples:</p>

<pre><code>    &quot;started since $time&quot;
    &quot;started since %s&quot;, $time
    &quot;fork: %m&quot;</code></pre>

<p>The follwing logging interface is made available to modules:</p>

<dl>

<dt id="logdbg-priority,-message"><a id="logdbg"></a><a id="logdbg-priority--message"></a>logdbg <i>priority</i>, <i>message</i></dt>
<dd>

<p>Debug logging of <i>message</i> to the <code>debug</code> channel.</p>

<p>You may specify any priority you want, i.e. a <code>debug</code> priority is not enforced here. You may even specify <code>&quot;notice:4&quot;</code> if you wish, to have the message logged if the debug level is set to 4 or less. If handed over to syslog(3), the message will nonetheless be logged at the <code>notice</code> priority.</p>

</dd>
<dt id="logtrc-priority,-message"><a id="logtrc"></a><a id="logtrc-priority--message"></a>logtrc <i>priority</i>, <i>message</i></dt>
<dd>

<p>Trace logging of <i>message</i> to the <code>output</code> channel.</p>

<p>Like logdbg() above, you are not restricted to the <code>info</code> priority. This routine checks the logging level (either explicit as in <code>&quot;info:14&quot;</code> or implicit as in <code>&quot;notice&quot;</code>) against the trace level.</p>

</dd>
<dt id="logdebug-message"><a id="logdebug"></a>logdebug <i>message</i></dt>
<dd>

<p>Log the message at the <code>debug</code> priority to the <code>output</code> channel.</p>

<p>The difference with logdbg() is twofold: logging is done on the <code>output</code> channel, not the <code>debug</code> one, and the priority is implicit.</p>

</dd>
<dt id="loginfo-message"><a id="loginfo"></a>loginfo <i>message</i></dt>
<dd>

<p>Log the message at the <code>info</code> priority to the <code>output</code> channel.</p>

</dd>
<dt id="logsay-message"><a id="logsay"></a>logsay <i>message</i></dt>
<dd>

<p>Log the message at the <code>notice</code> priority to the <code>output</code> channel. The logging always takes place under the default <code>-trace</code> settings, but only if the routine is called, naturally. This means you can still say:</p>

<pre><code>    logsay &quot;some trace message&quot; if $verbose;</code></pre>

<p>and control whether the message is emitted by using some external configuration for your module (e.g. by adding a -verbose flag to the creation routine of your class).</p>

</dd>
<dt id="logwarn-message"><a id="logwarn"></a>logwarn <i>message</i></dt>
<dd>

<p>Log a warning message at the <code>warning</code> priority to the <code>error</code> channel.</p>

</dd>
<dt id="logcarp-message"><a id="logcarp"></a>logcarp <i>message</i></dt>
<dd>

<p>Same as logwarn(), but issues a Carp::carp(3) call instead, which will warn from the perspective of the routine&#39;s caller.</p>

</dd>
<dt id="logcluck-message"><a id="logcluck"></a>logcluck <i>message</i></dt>
<dd>

<p>Same as logwarn(), but dumps a full stacktrace as well.</p>

</dd>
<dt id="logerr-message"><a id="logerr"></a>logerr <i>message</i></dt>
<dd>

<p>Log an error message at the <code>error</code> priority to the <code>error</code> channel.</p>

</dd>
<dt id="logdie-message"><a id="logdie"></a>logdie <i>message</i></dt>
<dd>

<p>Log a fatal message at the <code>critical</code> priority to the <code>error</code> channel, and then dies.</p>

</dd>
<dt id="logconfess-message"><a id="logconfess"></a>logconfess <i>message</i></dt>
<dd>

<p>Same as logdie(), but issues a Carp::confess(3) call instead. It is possible to configure the <code>Log::Agent</code> module via the <code>-confess</code> switch to automatically redirect a logdie() to logconfess(), which is invaluable during unit testing.</p>

</dd>
<dt id="logcroak-message"><a id="logcroak"></a>logcroak <i>message</i></dt>
<dd>

<p>Same as logdie(), but issues a Carp::croak(3) call instead. It is possible to configure the <code>Log::Agent</code> module via the <code>-confess</code> switch to automatically redirect a logcroak() to logconfess(), which is invaluable during unit testing.</p>

</dd>
<dt id="Log::Agent::inited"><a id="Log"></a>Log::Agent::inited</dt>
<dd>

<p>Returns true when <code>Log::Agent</code> was initialized, either explicitly via a logconfig() or implicitely via any logxxx() call.</p>

</dd>
</dl>

<p>Modules sometimes wish to report errors from the perspective of their caller&#39;s caller, not really their caller. The following interface is therefore provided:</p>

<dl>

<dt id="logxcarp-offset,-message"><a id="logxcarp"></a><a id="logxcarp-offset--message"></a>logxcarp <i>offset</i>, <i>message</i></dt>
<dd>

<p>Same a logcarp(), but with an additional offset to be applied on the stack. To warn one level above your caller, set it to 1.</p>

</dd>
<dt id="logxcroak-offset,-message"><a id="logxcroak"></a><a id="logxcroak-offset--message"></a>logxcroak <i>offset</i>, <i>message</i></dt>
<dd>

<p>Same a logcroak(), but with an additional offset to be applied on the stack. To report an error one level above your caller, set it to 1.</p>

</dd>
</dl>

<p>For applications that wish to implement a debug layer on top of <code>Log::Agent</code>, the following routine is provided. Note that it is not imported by default, i.e. it needs to be explicitly mentionned at <code>use</code> time, since it is not meant to be used directly under regular usage.</p>

<dl>

<dt id="logwrite-channel,-priority,-message"><a id="logwrite"></a><a id="logwrite-channel--priority--message"></a>logwrite <i>channel</i>, <i>priority</i>, <i>message</i></dt>
<dd>

<p>Unconditionally write the <i>message</i> at the given <i>priority</i> on <i>channel</i>. The channel can be one of <code>debug</code>, <code>error</code> or <code>output</code>.</p>

</dd>
</dl>

<p>At the application level, one needs to commit once and for all about the logging scheme to be used. This is done thanks to the logconfig() routine which takes the following switches, in alphabetical order:</p>

<dl>

<dt id="-caller-=&gt;-[-parameters-]"><a id="caller-----parameters"></a><code>-caller</code> =&gt; [ <i>parameters</i> ]</dt>
<dd>

<p>Request that caller information (relative to the logxxx() call) be part of the log message. The given <i>parameters</i> are handed off to the creation routine of <code>Log::Agent::Tag::Caller</code> and are documented there.</p>

<p>I usually say something like:</p>

<pre><code> -caller =&gt; [ -display =&gt; &#39;($sub/$line)&#39;, -postfix =&gt; 1 ]</code></pre>

<p>which I find informative enough. On occasion, I found myself using more complex sequences. See <a href="https://metacpan.org/pod/Log::Agent::Tag::Caller">Log::Agent::Tag::Caller</a>.</p>

</dd>
<dt id="-confess-=&gt;-flag"><a id="confess---flag"></a><code>-confess</code> =&gt; <i>flag</i></dt>
<dd>

<p>When true, all logdie() calls will be automatically masqueraded as logconfess().</p>

</dd>
<dt id="-debug-=&gt;-priority-or-level"><a id="debug---priority-or-level"></a><code>-debug</code> =&gt; <i>priority or level</i></dt>
<dd>

<p>Sets the priority threshold (can be expressed as a string or a number, the string being mapped to a logging level as described above in <b>PRIORITIES AND LEVEL</b>) for logdbg() calls.</p>

<p>Calls tagged with a level less than or equal to the given threshold will pass through, others will return prematurely without logging anything.</p>

</dd>
<dt id="-driver-=&gt;-driver_object"><a id="driver---driver_object"></a><code>-driver</code> =&gt; <i>driver_object</i></dt>
<dd>

<p>This switch defines the driver object to be used, which must be an heir of the <code>Log::Agent::Driver</code> class. See <a href="http://man.he.net/man3/Log::Agent::Driver">Log::Agent::Driver(3)</a> for a list of the available drivers.</p>

</dd>
<dt id="-level-=&gt;-priority-or-level"><a id="level---priority-or-level"></a><code>-level</code> =&gt; <i>priority or level</i></dt>
<dd>

<p>Specifies both <code>-debug</code> and <code>-trace</code> levels at the same time, to a common value.</p>

</dd>
<dt id="-prefix-=&gt;-name"><a id="prefix---name"></a><code>-prefix</code> =&gt; <i>name</i></dt>
<dd>

<p>Defines the application name which will be pre-pended to all messages, followed by <code>&quot;: &quot;</code> (a colon and a space). Using this switch alone will configure the default driver to use that prefix (stripped down to its basename component).</p>

<p>When a driver object is used, the <code>-prefix</code> switch is kept at the <code>Log::Agent</code> level only and is not passed to the driver: it is up to the driver&#39;s creation routine to request the <code>-prefix</code>. Having this information in Log::Agent enables the module to die on critical errors with that error prefix, since it cannot rely on the logging driver for that, obviously.</p>

</dd>
<dt id="-priority-=&gt;-[-parameters-]"><a id="priority-----parameters"></a><code>-priority</code> =&gt; [ <i>parameters</i> ]</dt>
<dd>

<p>Request that message priority information be part of the log message. The given <i>parameters</i> are handed off to the creation routine of <code>Log::Agent::Tag::Priority</code> and are documented there.</p>

<p>I usually say something like:</p>

<pre><code>        -priority =&gt; [ -display =&gt; &#39;[$priority]&#39; ]</code></pre>

<p>which will display the whole priority name at the beginning of the messages, e.g. &quot;[warning]&quot; for a logwarn() or &quot;[error]&quot; for logerr(). See <a href="https://metacpan.org/pod/Log::Agent::Tag::Priority">Log::Agent::Tag::Priority</a> and <a href="https://metacpan.org/pod/Log::Agent::Priorities">Log::Agent::Priorities</a>.</p>

<p><b>NOTE</b>: Using <code>-priority</code> does not prevent the <code>-duperr</code> flag of the file driver to also add its own hardwired prefixing in front of duplicated error messages. The two options act at a different level.</p>

</dd>
<dt id="-tags-=&gt;-[-list-of-Log::Agent::Tag-objects-]"><a id="tags-----list-of-Log::Agent::Tag-objects"></a><code>-tags</code> =&gt; [ <i>list of <code>Log::Agent::Tag</code> objects</i> ]</dt>
<dd>

<p>Specifies user-defined tags to be added to each message. The objects given here must inherit from <code>Log::Agent::Tag</code> and conform to its interface. See <a href="https://metacpan.org/pod/Log::Agent::Tag">Log::Agent::Tag</a> for details.</p>

<p>At runtime, well after logconfig() was issued, it may be desirable to add (or remove) a user tag. Use the <code>logtags()</code> routine for this purpose, and iteract directly with the tag list object.</p>

<p>For instance, a web module might wish to tag all the messages with a session ID, information that might not have been available by the time logconfig() was issued.</p>

</dd>
<dt id="-trace-=&gt;-priority-or-level"><a id="trace---priority-or-level"></a><code>-trace</code> =&gt; <i>priority or level</i></dt>
<dd>

<p>Same a <code>-debug</code> but applies to logsay(), logwarn(), logerr() and logtrc().</p>

<p>When unspecified, <code>Log::Agent</code> runs at the &quot;notice&quot; level.</p>

</dd>
</dl>

<p>Additional routines, not exported by default, are:</p>

<dl>

<dt id="logtags">logtags</dt>
<dd>

<p>Returns a <code>Log::Agent::Tag_List</code> object, which holds all user-defined tags that are to be added to each log message.</p>

<p>The initial list of tags is normally supplied by the application at logconfig() time, via the <code>-tags</code> argument. To add or remove tags after configuration time, one needs direct access to the tag list, obtained via this routine. See <a href="https://metacpan.org/pod/Log::Agent::Tag_List">Log::Agent::Tag_List</a> for the operations that can be performed.</p>

</dd>
</dl>

<h1 id="KNOWN-LIMITATIONS"><a id="KNOWN"></a>KNOWN LIMITATIONS</h1>

<p>The following limitations exist in this early version. They might be addressed in future versions if they are perceived as annoying limitatons instead of being just documented ones. :-)</p>

<ul>

<li><p>A module which calls logdie() may have its die trapped if called from within an eval(), but unfortunately, the value of $@ is unpredictable: it may be prefixed or not depending on the driver used. This is harder to fix as one might think of at first glance.</p>

</li>
<li><p>Some drivers lack customization and hardwire a few things that come from my personal taste, like the prefixing done when <i>duperr</i> is set in Log::Agent::Driver::File, or the fact that the <code>debug</code> and <code>stderr</code> channels are merged as one in the Log::Agent::Driver::Default driver.</p>

</li>
<li><p>When using logcroak() or logconfess(), the place where the call was made can still be visible when -caller is used, since the addition of the caller information to the message is done before calling the logging driver. Is this a problem?</p>

</li>
</ul>

<h1 id="AUTHOR">AUTHOR</h1>

<p>Log::Agent was originally authored by Raphael Manfredi <i>&lt;Raphael_Manfredi@pobox.com&gt;</i> and is currently maintained by Mark Rogaski <i>&lt;mrogaski@cpan.org&gt;</i>.</p>

<h1 id="LICENSE">LICENSE</h1>

<p>Copyright (c) 1999-2000 Raphael Manfredi.</p>

<p>Copyright (c) 2002-2003, 2005, 2013 Mark Rogaski; all rights reserved.</p>

<p>This module is free software. You can redistribute it and/or modify it under the terms of the Artistic License 2.0.</p>

<p>This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.</p>

<h1 id="SEE-ALSO"><a id="SEE"></a>SEE ALSO</h1>

<p>Log::Agent::Driver(3), Carp(3).</p></div>

<div id="metacpan_install-instructions-dialog" class="modal fade">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
        <h4 class="modal-title">Module Install Instructions</h4>
      </div>
      <div class="modal-body">
        <p>To install Log::Agent, copy and paste the appropriate command in to your terminal.</p>
        <p><a href="https://metacpan.org/dist/App-cpanminus/view/bin/cpanm">cpanm</a></p>
        <pre><code>cpanm Log::Agent</code></pre>
        <p><a href="https://metacpan.org/pod/CPAN">CPAN shell</a></p>
        <pre><code>perl -MCPAN -e shell
install Log::Agent</code></pre>
        <p>For more information on module installation, please visit <a href="https://www.cpan.org/modules/INSTALL.html">the detailed CPAN module installation guide</a>.</p>
      </div>
      <div class="modal-footer">
        <a href="./Log::Agent.html#" data-dismiss="modal" class="btn">Close</a>
      </div>
    </div>
  </div>
</div>
          </main>
          <div class="content-pagination">
          </div>
        </div>
        <footer class="footer">
          <div class="footer-container">
            <div class="footer-social">
              <div class="footer-link footer-logo">
                <a href="https://metacpan.org/">
                  <img src="https://metacpan.org/static/images/metacpan-logo.svg" alt="MetaCPAN" />
                </a>
              </div>
              <a class="footer-social-link" href="https://github.com/metacpan">
                <i class="fab fa-github-square"></i>
              </a>
              <a class="footer-social-link" href="https://fosstodon.org/@metacpan">
                <i class="fab fa-mastodon"></i>
              </a>
            </div>
            <div class="footer-links">
              <div class="footer-link">
                  <a href="https://metacpan.org/about">About</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/sponsors">Sponsor</a>
              </div>
              <div class="footer-link">
                  <a href="https://grep.metacpan.org">grep::cpan</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/recent">Recent</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/faq">FAQ</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/tools">Tools</a>
              </div>
              <div class="footer-link">
                  <a href="https://fastapi.metacpan.org/">API</a>
              </div>
              <div class="footer-link">
                  <a href="https://www.perl.org/">Perl.org</a>
              </div>
            </div>
            <div class="footer-sponsors">
              <a class="footer-sponsor-link" target="_blank" href="https://www.bytemark.co.uk/" rel="noopener">
                <img class="footer-sponsor-bytemark" src="https://metacpan.org/static/images/sponsors/bytemark_logo.svg" alt="Bytemark logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.liquidweb.com/" rel="noopener">
                <img class="footer-sponsor-liquidweb" src="https://metacpan.org/static/images/sponsors/liquidweb_logo.png" alt="liquidweb logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://deriv.com/careers/" rel="noopener">
                <img class="footer-sponsor-deriv" src="https://metacpan.org/static/images/sponsors/deriv.svg" alt="Deriv logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://geocode.xyz" rel="noopener">
                <img class="footer-sponsor-geocode" src="https://metacpan.org/static/images/sponsors/geocodelogo.svg" alt="Geocode logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.fastly.com/" rel="noopener">
                <img class="footer-sponsor-fastly" src="https://metacpan.org/static/images/sponsors/fastly_logo.svg" alt="Fastly logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://opencagedata.com" rel="noopener">
                <img class="footer-sponsor-opencage" src="https://metacpan.org/static/images/sponsors/open-cage.svg" alt="OpenCage logo">
              </a>
            </div>
          </div>
        </footer>
        <div class="modal fade" tabindex="-1" role="dialog" id="metacpan_keyboard-shortcuts">
          <div class="modal-dialog">
            <div class="modal-content">
              <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal">&times;</button>
                <h4 class="modal-title">Keyboard Shortcuts</h4>
              </div>
              <div class="modal-body row">
<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Global</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>s</kbd>
        </td>
        <td>Focus search bar</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>?</kbd>
        </td>
        <td>Bring up this help dialog</td>
      </tr>
    </tbody>
  </table>

  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>GitHub</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>p</kbd>
        </td>
        <td>Go to pull requests</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>go to github issues (only if github is preferred repository)</td>
      </tr>
    </tbody>
  </table>
</div>

<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>POD</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>a</kbd>
        </td>
        <td>Go to author</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>c</kbd>
        </td>
        <td>Go to changes</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>Go to issues</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>d</kbd>
        </td>
        <td>Go to dist</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>r</kbd>
        </td>
        <td>Go to repository/SCM</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>s</kbd>
        </td>
        <td>Go to source</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>b</kbd>
        </td>
        <td>Go to file browse</td>
      </tr>

    </tbody>
  </table>
</div>

<div class="col-md-12">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Search terms</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><em>module:</em> (e.g. <a href="https://metacpan.org/search?q=module%3APlugin">module:Plugin</a>)</td>
      </tr>
      <tr>
        <td><em>distribution:</em> (e.g. <a href="https://metacpan.org/search?q=distribution%3ADancer+auth">distribution:Dancer auth</a>)</td>
      </tr>
      <tr>
        <td><em>author:</em> (e.g. <a href="https://metacpan.org/search?q=author%3ASONGMU+Redis">author:SONGMU Redis</a>)</td>
      </tr>
      <tr>
        <td><em>version:</em> (e.g. <a href="https://metacpan.org/search?q=version%3A1.00">version:1.00</a>)</td>
      </tr>
    </tbody>
  </table>
</div>
              </div>
              <div class="modal-footer"></div>
            </div>
          </div>
        </div>
    </body>
</html>
